home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 015a / write211.zip / WRITE.DOC < prev    next >
Text File  |  1993-03-20  |  12KB  |  306 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         
  8.                             
  9.                             
  10.                             
  11.                             
  12.                             
  13.                             
  14.                             
  15.                             
  16.                             
  17.                             
  18.                             
  19.                             
  20.                             
  21.                             
  22.                             
  23.                             
  24.                             STEENBURGH'S STUFF
  25.                           Mildly Useful Utilities
  26.                               For Batch Files
  27.                                Version  2.51
  28.           Copyright 1991-1993 by Chuck Steenburgh and Tay-Jee Software
  29.         
  30.                             _______
  31.                        ____|__     |               (TM)
  32.                     --|       |    |-------------------
  33.                       |   ____|__  |  Association of
  34.                       |  |       |_|  Shareware
  35.                       |__|   o   |    Professionals
  36.                     -----|   |   |---------------------
  37.                          |___|___|    MEMBER
  38.         
  39.         
  40.         
  41.         
  42.         
  43.         
  44.         
  45.         
  46.         
  47.         
  48.         
  49.         
  50.         
  51.         
  52.         
  53.         
  54.         
  55.         
  56.         
  57.         
  58.         
  59.         
  60.         
  61.  
  62.                                      Page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.         WRITE.EXE 2.1
  69.         Copyright 1991 by Chuck Steenburgh & Tay-Jee Software
  70.         
  71.            We know that ECHO has its limits, don't we?  WRITE will let
  72.         you have full control over the positioning and color of your
  73.         text messages in batch files.  Version 2.0 adds the capability  |
  74.         to have write display text files, similar to DOS's TYPE|MORE    |
  75.         combination, but in FULL color that you specify.                |
  76.         
  77.         Usage:       WRITE "Text"|@file [ccc] [/C] [/Rn] [/Ln] [/S] [/H]|
  78.         
  79.                   "Text"          This is the text to be displayed,
  80.                                   which must be enclosed in quotes if   |
  81.                                   it consists of more than one word.    |
  82.                                   
  83.                   @file           Name of file containing ASCII text to |
  84.                                   be displayed.  Can be specified in    |
  85.                                   lieu of "Text."                       |
  86.                                                                    
  87.                   ccc             This is the color in which to print   |
  88.                                   the text.  See Appendix 3.
  89.                                   
  90.                   /C              Centers text on line.                 |
  91.         
  92.                   /Rn             n is the row (0-24, top to bottom) on |
  93.                                   which the text will appear.  The de-  |
  94.                                   fault is to use the current cursor    |
  95.                                   position.                             |
  96.                                                                      
  97.                   /Ln             n is the column (0-79, left to right) |
  98.                                   where the text will begin printing.   |
  99.                                   The default is to use the current cur-|
  100.                                   sor position.                         |
  101.         
  102.                   /S              Include this switch to utilize slow
  103.                                   (BIOS) screen writes.  This will
  104.                                   suppress "snow" on some CGA displays.
  105.                                   
  106.                   /H              Displays brief help screen.           |
  107.         
  108.         Examples:
  109.         
  110.              WRITE "This is my message."                                |
  111.              
  112.              Displays "This is my message" on the current line in gray  |
  113.         on black background (same as ECHO This is my message., only     |
  114.         MUCH faster).                                                   |
  115.         
  116.              WRITE "This is my message." 79                             |
  117.              
  118.              Displays "This is my message." on the current line in      |
  119.         bright white on red background.                                 |
  120.         
  121.              WRITE "Hello, Chuck." /r10 /l25                            |
  122.  
  123.                                      Page 2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.              
  130.              Displays "Hello, Chuck." on row 10, column 25, in gray on  |
  131.         black background.                                               |
  132.         
  133.              WRITE "Goodbye, Chuck." /r5 /c /s 207                      |
  134.              
  135.              Displays "Goodbye, Chuck." centered on row 5 in flashing   |
  136.         bright white on red background.  Suppresses snow on old CGA sys-|
  137.         tems.                                                           |
  138.         
  139.              WRITE @write.doc 15                                        |
  140.              
  141.              Displays this documentation file on the screen in bright   |
  142.         white on black background.                                      |
  143.         
  144.            Only display color and the "/S" switch may be specified if   |
  145.         a text file is to be displayed.  The screen will be cleared,    |
  146.         and text will be displayed a screen at a time.  Users will be   |
  147.         prompted with the familiar "Press any key to continue..." mes-  |
  148.         sage to continue on to the next screen.                         |
  149.         
  150.            WRITE returns errorlevels as follows:
  151.         
  152.              0   Normal termination                                     
  153.              1   Text file displayed                                    |
  154.              2   Help screen displayed                                  |
  155.         
  156.            Note to users of WRITE 1.1 or 1.0:                           |
  157.            
  158.            Commands written for earlier versions of WRITE are not com-  |
  159.         patible with WRITE 2.0.  Sorry, but the new features included   |
  160.         with WRITE 2.0 demanded a different system of passing parameters|
  161.         to the program.  The current switches are similar to those used |
  162.         with the remainder of STEENBURGH'S STUFF utilities.  The ori-   |
  163.         ginal two releases of WRITE were little more than executable    |
  164.         versions of some "C" functions I had written for use in other   |
  165.         programs, while version 2.0 is a completely new, much more flex-|
  166.         ible and capable utility.                                       |
  167.         
  168.          
  169.         OMBUDSMAN
  170.         
  171.           This program is produced by a member of the Association of
  172.         Shareware Professionals (ASP).  ASP wants to make sure that
  173.         the shareware principle works for you.  If you are unable to
  174.         resolve a shareware-related problem with an ASP member by
  175.         contacting the member directly, ASP may be able to help.  The
  176.         ASP Ombudsman can help you resolve a dispute or problem with
  177.         an ASP member, but does not provide technical support for 
  178.         members' products.  Please write to the ASP Ombudsman at 545
  179.         Grover Road, Muskegon, MI 49442 or send a CompuServe message
  180.         via CompuServe Mail to ASP Ombudsman, 70007,3536.
  181.         
  182.         
  183.  
  184.                                      Page 3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.         DISCLAIMER
  191.         
  192.            The programs described in this documentation are guaran-
  193.         teed to do absolutely nothing!  They have, however, in my exper-
  194.         ience performed essentially as described herein.  The author
  195.         will not be responsible for any loss or damages caused through
  196.         the use of these programs.  No warranty, express or implied,
  197.         is provided for this software's performance, merchantability,
  198.         or fitness for a particular purpose.
  199.         
  200.            All trademarks are property of their respective owners.
  201.         
  202.            The programs and documentation are Copyright 1991,1992 by 
  203.         Chuck Steenburgh.  You are encouraged to distribute these pro-
  204.         grams provided the following conditions are met:
  205.         
  206.            - all files contained in the archive or distribution disk
  207.              must be distributed together in UNMODIFIED form
  208.         
  209.            - you charge no more than a reasonable fee for copying or
  210.              subscription, and clearly indicate that payment of such
  211.              a fee does NOT grant ownership of the programs.
  212.         
  213.            This program is part of set of utilities known as STEEN-
  214.         BURGH'S STUFF (Mildly Useful Utilities).  The full set of
  215.         utilities includes the following programs:
  216.         
  217.              BATBOX:     Simple menu creation/input system
  218.              CHKDRV:     Checks disk drive status
  219.              CHKPRN:     Checks parallel printer status
  220.              CLK:        Displays time on screen
  221.              CURSOR:     Change cursor shape
  222.              DOSVER:     Checks for DOS version currently running
  223.              INPUT:      Simple prompt/input system
  224.              KLS:        Colorful screen-clearing utility
  225.              LAUNCHER:   File selection/execution system
  226.              MUSIC:      Plays transcribed sheet music on the PC
  227.              RAND:       Random number generator
  228.              SKIP:       Prints blank lines from batch files
  229.              SOUNDER:    Wide range of noise making options
  230.              SPACE:      File/disk space reporting utility
  231.              WAITFOR:    Timed pauses 
  232.              WHENISIT:   Date/time telling utility
  233.              WRITE:      Colorful output anywhere on screen
  234.              XD:         Create/switch directories at the same time
  235.         
  236.            You may evaluate these programs for up to 30 days on a free
  237.         trial basis.  After 30 days, you should register your use of
  238.         these programs.  The registration fee is $20, payable to the
  239.         author at the address given below.  For those registering
  240.         directly with Tay-Jee Software, we offer a $5 cash discount.
  241.         
  242.            Let's be real: I don't plan to make a lot of money this way.
  243.         Registration does have its advantages:
  244.  
  245.                                      Page 4
  246.  
  247.  
  248.  
  249.  
  250.  
  251.         
  252.            - I am improving these programs all the time.  Registration
  253.              will get you IMMEDIATELY a disk with the latest version.
  254.              You will also get the next major release of the program set
  255.              sent to you free of charge.
  256.         
  257.            - While I can't promise to include everyone's suggestions
  258.              in program updates, you can bet I'll listen to registered
  259.              users before any of you scrounges out there.
  260.         
  261.            - You will make me feel all warm and fuzzy and appreciated, 
  262.              and all that good stuff.
  263.         
  264.            - You will also get an evaluation copy of my text file for-
  265.              matting program (used to produce the margins in this doc-
  266.              ument), and any other electronic creations I have decided
  267.              to unleash on a foolish, unsuspecting world.
  268.         
  269.            Send comments/registrations to:
  270.         
  271.                 Tay-Jee Software
  272.                 Post Office Box 835
  273.                 Lexington, VA 24450
  274.                 (703)464-5290
  275.                 
  276.                 !!!VIRGINIA RESIDENTS ADD 4.5SALES TAX!!!
  277.         
  278.                 CIS 72330,1776 (I haunt the IBMSYS and IBMPRO forums)
  279.         
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.                                      Page 5